home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / database / sigrea.zip / README.TXT < prev    next >
Text File  |  1994-05-16  |  7KB  |  157 lines
  1. SIGREADER Version 1.0
  2.  
  3.  
  4. Files Included:
  5. SIGREADR.CH  --  SIGREADER include file.
  6. SIGREADR.OBJ --  SIGREADER obj for linking..
  7. SIGRDRGR.OBJ --  SIGREADER obj for linking utilizing Grumpfish functions.
  8. README.TXT   --  you're reading it.
  9. ORDER.TXT    --  Order file for registering.
  10.  
  11. SIGREADER is written by Stan Grossman
  12. Copyright 1994
  13. SIG Software
  14. 9074 Andromeda Drive
  15. Burke, VA  22015-3510
  16. CIS# 72624,3050
  17.  
  18.  
  19.  SOFTWARE LICENSE 
  20.  
  21.  SIGREADER is not and has never been public domain software, nor is it free software. 
  22.  
  23.  Non-licensed users are granted a limited license to use SIGREADER on a 30-day trial basis for the 
  24. purpose of determining whether SIGREADER is suitable for their needs.  The use of SIGREADER, except 
  25. for the initial 30-day trial, requires registration.  The use of unlicensed copies of SIGREADER by any 
  26. person, business, corporation, government agency or any other entity is strictly prohibited. 
  27.  
  28.  A single user license permits a user to use SIGREADER only on a single computer.  Licensed users 
  29. may use the program on different computers, but may not use the program on more than one 
  30. computer at the same time. Licensed users may distribute this library only in the form of compiled code
  31. included in their applications.
  32.  
  33.  No one may modify or patch the SIGREADER executable files in any way,  including but not limited 
  34. to decompiling, disassembling, or otherwise reverse engineering the program. 
  35.  
  36.  A limited license is granted to copy and distribute SIGREADER only for the trial use of others, subject 
  37. to the above limitations, and also the following: 
  38.  
  39.   1)    SIGREADER must be copied in unmodified form, complete with the file containing this license 
  40. information and only the following SIGREADER files: SIGREADR.CH, SIGREADR.OBJ, SIGRDRGR.OBJ, ORDER.TXT and README.TXT.
  41. You may NOT distribute the SIGREADER registration ID. 
  42.  
  43.   2)    The full machine-readable SIGREADER documentation must be included with each copy. 
  44.  
  45.   3)    No fee, charge, or other compensation may be requested or accepted, except as 
  46. authorized below: 
  47.  
  48.         A) Operators of electronic bulletin board systems (sysops) may make SIGREADER available for 
  49. downloading only as long as the above conditions are met.  An overall or time-dependent charge 
  50. for the use of the bulletin board system is permitted as long as there is not a specific charge for 
  51. the download of SIGREADER. 
  52.  
  53.         B) Vendors of user-supported or shareware software may distribute 
  54. SIGREADER, subject to the above conditions, without specific permission. Vendors may 
  55. charge a disk duplication and handling fee, which, when pro-rated to the SIGREADER product, may 
  56. not exceed five dollars. 
  57.  
  58.         C) Non-profit user groups may distribute SIGREADER, subject to the above conditions, without 
  59. specific permission. Non-profit user groups may charge a disk duplication fee, which, when pro-
  60. rated to the SIGREADER product, may not exceed five dollars. 
  61.  
  62.   LIMITED WARRANTY 
  63.   EXCEPT AS PROVIDED ABOVE, SIG SOFTWARE DISCLAIMS ALL 
  64.   WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT 
  65.   LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND 
  66.   FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE 
  67.   PRODUCT.  SHOULD THE PROGRAM PROVE DEFECTIVE, THE 
  68.   PURCHASER ASSUMES THE RISK OF PAYING THE ENTIRE COST OF 
  69.   ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND ANY 
  70.   INCIDENTAL OR CONSEQUENTIAL DAMAGES.  IN NO EVENT WILL 
  71.   SIG SOFTWARE BE LIABLE FOR ANY DAMAGES WHATSOEVER 
  72.   (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF 
  73.   BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS 
  74.   INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE 
  75.   INABILITY TO USE THIS PRODUCT EVEN IF SIG SOFTWARE 
  76.   HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 
  77.  
  78.   Use of this product for any period of time constitutes your acceptance of this agreement and 
  79. subjects you to its contents. 
  80.  
  81.   U.S. GOVERNMENT RESTRICTED RIGHTS 
  82.  
  83.   Use, duplication, or disclosure by the Government is subject to restrictions as set forth in 
  84. subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-
  85. 7013.  Contractor/manufacturer is SIG Software. 
  86.  
  87.  
  88.  
  89. USERS GUIDE
  90. ___________
  91.  
  92.  
  93. SIGREADER has ben written in native Clipper code.  It may be overlayed.
  94. Simply add an:
  95.  
  96.        #include "sigreadr.ch"
  97.  
  98. statement in .PRG using SIGREADER constructs and add either SIGREADR.OBJ
  99. or SIGRDRGR.OBJ to your FILE list.
  100.  
  101.  
  102. SIGREADR.OBJ contains standard Clipper code and memo functions and may be
  103. used in any Clipper application.  SIGRDRGR.OBJ contains a modified version
  104. of Grumpfish's POPNOTE function.  It is called GETNOTE and uses memo or
  105. character fields/variables instead of a text file.  In order to use
  106. SIGRDRGR.OBJ, you must already own a copy of the Grumpfish Library because
  107. the GETNOTE function calls several Grump functions; it will only work if
  108. the Grumpfish Library is also linked in.
  109.  
  110.  
  111. These constructs may be used just like any native SAY/GET statement if the
  112. SIGREADER has been linked in.
  113.  
  114.  
  115. @ <nRow>, <nCol> SIGGET <var> RIGHT [PICTURE <cPic>]
  116.                                     [VALID <valid>]
  117.                                     [WHEN <when>]
  118.                                     [MESSAGE <cText>]
  119.                                     [COLOR <cColor>]
  120.  
  121.     This command right justifies data as it is entered.  This is helpful for
  122.     entering ID numbers to get "  12" instead of "12  " which keeps indexes
  123.     straight.  The <var> must be of character type, all other clauses are
  124.     standard Clipper.
  125.  
  126.  
  127.  
  128. @ <nRow>, <nCol> SIGGET <var> LOGICAL [WHEN <when>]
  129.                                       [VALID <valid>]
  130.                                       [COLOR <cColor>]
  131.  
  132.     This command causes a logical <var> to be displayed as "Yes" or "No".
  133.     It takes standard input (either Y/N or T/F) but displays "Yes" or "No".
  134.     <var> must be a logical type.  Obviously, the validation is inherent
  135.     in the field type, but I have included a VALID clause so that you can 
  136.     branch to a function and do somethiong when this field loses focus.
  137.  
  138.  
  139.  
  140. @ <nRow>, <nCol> SIGSAY <var> MEMO <nLen>, <nLines> [COLOR <cColor>]
  141.  
  142. @ <nRow>, <nCol> SIGGET <var> MEMO <nLen>, <nLines> [COLOR <cColor>]
  143.                                                     [WHEN <when>]
  144.                                                     [NOSTAMP]
  145.  
  146.     These two commands display or display/get a memo/char variable.  The
  147.     memo is displayed for <nLines> of <nLen> length.  A SIGSAY...MEMO will
  148.     append an ellipse (...) at the end of the last line if the memo continues
  149.     for more lines than shown.  The SIGGET...MEMO will automatically
  150.     time stamp each entry; if this is not desired include the NOSTAMP clause.
  151.     The memo field will be displayed and encountered just like any other get
  152.     however to exit the SIGGET...MEMO you must type a ^W or ESC key
  153.     (or the equivalent).  This wil only exit the get not close the screen 
  154.     (it eats the key stroke).  This command makes handling memos as easy as
  155.     any other field -- no more special keys and function keys.
  156.  
  157.